home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / asla_120.zip / ASLA.DOC < prev    next >
Text File  |  1989-08-22  |  21KB  |  380 lines
  1.  
  2.                      ════════════════════════════════════
  3.                      ▄█▄        ▄██▄    ███      ▄█▄     
  4.                       ▀██▄     ▀███▄    ███       ▀██▄   
  5.                       ▄▄▀██▄     ▀███▄  ███       ▄▄▀██▄ 
  6.                      ██▀  ▀██      ███  ███      ██▀  ▀██
  7.                      ██▄▄▄▄██ ▄▄▄▄████  ███▄▄▄▄▄ ██▄▄▄▄██
  8.                      ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀
  9.                      ────────────────────────────────────
  10.  
  11.              Advanced System.Log Analyzer v1.20 for QuickBBS v2.04
  12.           Written by Gerard van der Land in Microsoft QuickBASIC 4.5
  13.       (C) Copyright 1989 Holland Computer Software. All rights reserved.
  14.  
  15.                               Released 22-Aug-89
  16.  
  17.       ■══════════════════════════════════════════════════════════════════■
  18.  
  19.                                  WHAT IS ASLA?
  20.                                 ■─────────────■
  21.  
  22. ASLA analyzes your SYSTEM.LOG, makes a statistical report in ASLA.A??, creates
  23. LASTUSER.A?? with the last 20 users on the system (with baud rate), updates the
  24. download counters like FILESCNT (Tony Bauman) for files downloaded with both
  25. FileDoor and QuickBBS, and also makes a Bulletin Board with read-counters. ASLA
  26. can be started after each user, because the program always continues analyzing
  27. where it ended the last times, which makes it very fast.
  28.  
  29.                      DISCLAIMER AND OTHER IMPORTANT STUFF
  30.                     ■────────────────────────────────────■
  31.  
  32. The following points must be considered, understood and agreed upon BEFORE you
  33. use ASLA v1.20:
  34.  
  35. ■ This documentation and the accompanying program is copyrighted material by
  36.   Gerard van der Land and Holland Computer Software.
  37.  
  38. ■ Although care has been taken to write and test a program that does what this
  39.   documentation states, the program is provided as it is, without warranty or
  40.   guarantee of any kind, either expressed or implied, as to the quality or
  41.   performance of this program, except that it will occupy disk space.
  42.  
  43. ■ The author will not be held liable to you or anyone for any direct, indirect,
  44.   incidental or consequential damages, including any lost profits, lost savings
  45.   which may result from the use or inability to use this program.
  46.   Your use of the program constitutes your agreement to this disclaimer and
  47.   your release of the author from any form of liability or litigation.
  48.  
  49. ■ I grant you a limited license to use ASLA v1.20 and encourage you to copy and
  50.   distribute it in the self-extracting archive in which it came (ASLA_120.COM)
  51.   as much as you want as long as you still abide to the conditions mentioned
  52.   here and no money or other compensation is asked or accepted.
  53.  
  54.                                HOW DOES IT WORK?
  55.                               ■─────────────────■
  56.  
  57. 1. ASLA analyzes you SYSTEM.LOG and counts the following things:
  58.  
  59. ■ Number of callers at 300, 1200, 2400 and 9600 baud, number of new users and
  60.   total number of callers.
  61.  
  62.   ASLA will put "N/A" after the baudrate that are not supported on your BBS. It
  63.   wil get this information from CONFIG.BBS.
  64.   ASLA creates LASTUSER.A?? with date, time, name and baud rate of the last 20
  65.   users in LASTUSER.A??. When the sysop logs on without "fast logon", ASLA
  66.   doesn't count that for a call at the highest baud rate, but mentions it as
  67.   "Loc." (local) in the LASTUSER.A?? files, even if the sysop called from the
  68.   outside. There's just no way to see the difference as long as Adam Hudson
  69.   doesn't put a "on-line at 0 baud" in the SYSTEM.LOG.
  70.  
  71. ■ Usage of the Xmodem (including 1k), Ymodem, Zmodem and SEAlink protocols,
  72.   total number of downloads and uploads.
  73.  
  74.   ASLA puts the full path names of the downloaded files in FILEDIFF.LOG. Later
  75.   this file will be used to update the download counters and erased. ASLA also
  76.   updates a special Download and Uploads log file, just like FileDoor does with
  77.   the name of the user after each file, but they include the PE-transfers too!
  78.  
  79. ■ Number of messages written and deleted, number of times the sysop was paged
  80.   and chatted with a user and the number of bulletins that were read.
  81.  
  82.   If you enabled the "Bulletin" keyword in ASLA.CFG, ASLA can produce a .A??
  83.   version of a Bulletin Board with 13 subjects and read-counters. Therefore it
  84.   needs the file BULLETIN.DAT. The first line of that file looks like this:
  85.  
  86.   "BULLET_","Title of the Bulletin Board comes here"
  87.  
  88.   "BULLET_" is the filename of the master file used with QuickBBS menu type 6
  89.   "Selection menu". It can be maximum 7 characters long, but I recommend NOT to
  90.   use a shorter filename, since QuickBBS will then allow the user to enter more
  91.   than one character when selecting a bulletin. The title will be centered on
  92.   top of the board. After that, 13 lines follow, which all like this:
  93.  
  94.   "A","Subject of this Bulletin Board comes here         ",8
  95.  
  96.   "A" is the character the user has to enter and also the last character of the
  97.   sub file, in this example "BULLET_A.A??". You are free to choose a character,
  98.   only "L" is not allowed, since it is used by QuickBBS to display the master
  99.   file "BULLET_.A??". The digit 8 is the number of times this Bulletin was
  100.   read. When you replace it, fist run ASLA to make sure there no more info in
  101.   SYSTEM.LOG that could update this counter, change the subject and zero the
  102.   counter. After that you can type "ASLA /BUL" to make a new Bulletin Board.
  103.  
  104. 2. After analyzing SYSTEM.LOG, the ASCII and ANSI files are created in the
  105.    QuickBBS text files directory (at least if ASLA could find the CONFIG.BBS,
  106.    otherwise in the current directory).
  107.  
  108. 3. If you enabled the "FilesCount" keyword in ASLA.CFG, then the second half
  109.    of the program starts: FILEDIFF.LOG is loaded, sorted on directory name and
  110.    truncated. After that for each directory from which a file was downloaded
  111.    (or all directories found in FLSEARCH.CTL if you used the /ALL switch):
  112.  
  113. a. FILES.BBS is loaded and FILES.$$$ created. If ASLA can't find a FILES.BBS,
  114.    then all files downloaded from that directory go back to FILEDIFF.LOG. ASLA
  115.    will re-try to update them next time until you should either make sure that
  116.    ASLA can find that FILES.BBS or change/delete FILEDIFF.LOG.
  117. b. With every line that contains a filename, the following things are done:
  118.    ■ Missing [0] will be added.
  119.    ■ Missing description "New File. Description unknown" will be added.
  120.      This text can be changed with the keyword Description in ASLA.CFG.
  121.    ■ Superfluous spaces will be removed.
  122.    ■ If you enabled the "Space" keyword in ASLA.CFG, ASLA will put a space
  123.      behind [nn], otherwise existing space(s) will be removed.
  124.    ■ The download counter will be increased if that file was downloaded.
  125.    ■ The filename will be expanded so it always fills 12 characters
  126.    ■ The description will be trimmed if it is longer than 47 characters, to
  127.      make sure that a file won't occupy more than one line when you use
  128.      QuickBBS menu type 31 "List FILES.BBS".
  129. c. FILES.BAK will be deleted if it exists.
  130. d. FILES.BBS will be renamed to FILES.BAK
  131. e. FILES.$$$ will be renamed to FILES.BBS. This file will NOT contain a
  132.    End Of File character ^Z, so you don't need to strip it.
  133.  
  134. 4. Finally ASLA will update BULLETIN.DAT and ASLA.SYS. This file contains info
  135.    to make ASLA continue next time where ended this time, which makes it
  136.    possible to run ASLA after each user instead of each 24 hours. Don't forget:
  137.       ┌──────────────────────────────────────────────────────────────────┐
  138.       │ ■ When SYSTEM.LOG is deleted, you HAVE TO delete ASLA.SYS too! ■ │
  139.       └──────────────────────────────────────────────────────────────────┘
  140.    Some checking is done which makes ASLA abort if ASLA.SYS and SYSTEM.LOG
  141.    don't match, so it can't do any harm if you forget. An other way is to use
  142.    the /KILL switch, which will make ASLA delete the SYSTEM.LOG when done (so
  143.    if you want a backup, make one BEFORE running ASLA) but keeps ASLA.SYS, so
  144.    the statistics/lastusers are over a longer period. It is up to you to delete
  145.    ASLA.SYS when the numbers are gett